home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1996 #15
/
Monster Media Number 15 (Monster Media)(July 1996).ISO
/
rem_acc
/
listv10.zip
/
RALISTER.DOC
< prev
next >
Wrap
Text File
|
1996-04-13
|
14KB
|
334 lines
· ∙ Imagine Productions ∙ ·
Presents
RA-Lister
▀▀▀▀▀▀▀▀▀
Version 1.0
(C) 1996 by Jason Raphael
─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-─-
─═─ Welcome to RA-Lister v1.0! ─═─
RA-Lister v1.0 was programmed and designed by Jason Raphael, April 1996.
Completed at 10:46am, 04-13-96.
- 1 -
──═════════════════════──
Table of Contents
──═════════════════════──
Table of Contents........1
Information..............2
Legal Information........3
Archive Contents.........4
Installation.............5
Program Usage............6
Editing BBS List.........7
RA-Lister Log............8
Registration.............9
Credits..................10
Support..................11
Other Fine RA Utils......12
- 2 -
──═════════════════════──
Information
──═════════════════════──
RA-Lister is a RemoteAccess questionnaire (q-a) script. This means that
it will load extremely fast from RA, and you can still see the RA status
bar and use all RA SysOp keys while in the program. RA-Lister has many
features, including:
- Ability for users to add their own entries..
- Full logging of all activity in RA-Lister to a separate log..
- Creates a very nice, professional looking listing..
- Will not allow a user to enter a listing without all necessary
information - If a field is left blank, the user is prompted to
abort the entry..
- Easy to edit listing..
- ...And much more!
- Notice on modifications of questionnaire:
Although I don't see any reason to, you may modify the text in this
questionnaire (such as the menus, etc). I only have one small
requirement about this: You must leave the blue status bar at the top
of every screen (as it is now) with the program name on it, the exact
way it is by default.
- 3 -
──═════════════════════──
Legal Information
──═════════════════════──
Neither myself (Jason Raphael) nor Dream Scape BBS can be held
responsible for any damage this program may cause on your system. It
HAS been thoroughly tested on my system as well as other systems, and to
the best of my knowledge works fine. After all, it is only an RA
questionnaire. <grin> :) If you DO for some reason encounter any
problems with it, however, neither of the above mentioned parties take
any responsibility for it.
You are encouraged to distribute RA-Lister, as long as it is in its
original archive with all files included and NOT modified in any way.
- 4 -
──═════════════════════──
Archive Contents
──═════════════════════──
The RA-Lister archive (LISTV10.ZIP) should contain the following files:
DONATE.FRM Donation form
FILE_ID.DIZ Program identification
INSTALL.BAT Installation program
LISTER.20X Main Q-A file for RA v2.0x
LISTER.25X Main Q-A file for RA v2.5x
LISTER.BAT Batch file used by RA-Lister
RALISTER.DOC RA-Lister documentation (you're reading it!)
README.1ST Important installation information
The following files will be created after RA-Lister is executed:
LISTER.ANS BBS listing ANSI screen (in your textfiles dir)
LISTER.LOG RA-Lister logfile (only with RA 2.5x) (in your RA dir)
- 5 -
──═════════════════════──
Installation
──═════════════════════──
For quick and simple installation, please run INSTALL.BAT (included with
RA-Lister). This program will detect what version of RemoteAccess you
are running, and copy all necessary files to their proper locations.
All that you will need to do after running INSTALL is add the option
to run RA-Lister in the menu(s) you'd like.
INSTALL.BAT will do the following items for you:
- Select the appropriate questionnaire for your system (based upon what
version of RemoteAccess you are using) and copy it to your
RemoteAccess questionnaire directory. (Due to certain options RA
2.5x's questionnaire script has that RA 2.0x's does not, there are two
Q-A files included with this program. If you're running RemoteAccess
v2.0x, LISTER.20X will be renamed to LISTER.Q-A. If you're running
RemoteAccess v2.5x, LISTER.25X will be renamed to LISTER.Q-A. The
main difference between the 2.0x enhanced version and the 2.5x
enhanced version of RA-Lister is logging: Logging of activity within
the program is only available within the 2.5x version.)
- Copy LISTER.BAT to your RemoteAccess system directory for RA-Lister to
access. If for some reason your RA system directory is not in your
PATH statement, you will need to move it to a directory that is (such
as C:\DOS).
INSTALL needs only three pieces of information to properly run:
- The TXTFILES environment variable must point to your RA textfiles
directory (ex: SET TXTFILES=D:\TXTFILES). RA-Lister requires that
this variable be set for the program to operate.
- The RA environment variable must point to your RemoteAccess system
directory (ex: SET RA=D:\RA).
- The full path (including drive letter) to your RA questionnaire
directory must be specified on the commandline WITHOUT A TRAILING
BACKSLASH (ex: INSTALL D:\RA\Q-A).
Now, all that is left is to add the option in your menus:
∙ Setting up RA-Lister v1.0 in a RemoteAccess menu
a) Enter RACONFIG -> Menu editor
b) Go to the menu(s) that you wish to have an option to run RA-Lister on.
c) Make a new menu entry as follows:
Action Execute a questionnaire (Type 12)
Display ; <-- Your display may vary
OptData LISTER
HotKey L <-- Your hotkey may vary
AutoExec No
Colour Colour example
MinSec 0 TimeUsed 0 FlatCost 0
MaxSec 0 TimeLeft 0 TimeCost 0
A flags -------- Age 0 Terminal ANSI RIP
B flags -------- MinSpeed 0 Nodes
C flags -------- MaxSpeed 0 Groups
D flags -------- Credit 0 DayTimes
You must have an ANSI driver loaded (such as ANSI.SYS) to use RA-Lister.
At this point in time, RA-Lister does not support ASCII. Make sure that
you set the terminal type to ANSI and RIP, since ASCII is not supported.
If there is enough demand, RA-Lister could support ASCII in a future
release.
NOTE: If you're currently running RA v2.0x, and you upgrade to v2.5x
at a later time, repeat these steps again to upgrade to the
2.5x enhanced version of RA-Lister.
- 6 -
──═════════════════════──
Program Usage
──═════════════════════──
RA-Lister is very simple and easy to use. Upon entering the program,
you are presented with the following menu:
V) View BBS listing
A) Add BBS to listing
Q) Quit RA-Lister
Selecting 'V' to view the BBS listing will, of course, display the BBS
listing database. Option 'A' takes the user through a question process
to add a new BBS to the list, and obviously 'Q' exits the program and
returns to the BBS.
- 7 -
──═════════════════════──
Editing BBS List
──═════════════════════──
Editing the BBS list that RA-Lister creates and uses is also quite simple
to do. The BBS list is located in your RA textfiles directory with a
filename of LISTER.ANS. Just load your favorite ANSI screen editor (such
as TheDraw), load LISTER.ANS, and make any changes/deletions you want to.
- 8 -
──═════════════════════──
RA-Lister Log
──═════════════════════──
RA-Lister will create a logfile of all activity. The time a user entered
the program will be logged, as well as any additions they make to the
BBS list. Here is an example of how the logfile will look after someone
adds an entry:
RA-Lister executed by Jason Raphael [Jammer] on node 2 (03-20-96, 20:11)
- Added BBS entry: Dream Scape BBS
- Exited RA-Lister (20:11)
The RA-Lister logfile will be created in your RA system directory with
the filename LISTER.LOG.
NOTE: Due to to certain options RA 2.5x's questionnaire script has that
RA 2.0x's does not, logging is only available in the 2.5x version
of RA-Lister (see Installation section of documentation for more
information).
- 9 -
──═════════════════════──
Registration
──═════════════════════──
You are not required to pay any kind of fee to use this program. I've
put a lot of my time into making RA-Lister look just right, fixing every
little detail, etc. There are no special features or extras you get for
sending a donation, but I'm definitely more likely to release future
versions and other q-a programs if I were to receive some donations. I
suggest a small donation of $5. Please see DONATE.FRM for donation
information.
Even if you choose not to donate, if you enjoy the program, I'd really
appreciate receiving some kind of postcard or letter from you. My
mailing address is at the end of this document.
- 10 -
──═════════════════════──
Credits
──═════════════════════──
Although RA-Lister is a somewhat new project, a lot of work has been put
into it. There are some people that I'd like to thank for their help,
without which RA-Lister wouldn't be where it is today (in no particular
order):
- Brad Meyer, Imagine Productions beta tester and internet
distributor for his support, ideas, and testing of RA-Lister, as
well as his distribution of Imagine Productions programs via the
internet..
- Andrew Milner - If it weren't for him, RemoteAccess wouldn't be
here, and this program would be useless.
- 11 -
──═════════════════════──
Support
──═════════════════════──
You can always obtain the latest version of RA-Lister by:
∙ FREQing magicname RA-LISTER from Dream Scape BBS, 1:284/22, any time
but ZMH up to 28.8 bps..
∙ Logging on to the Imagine Productions Support Site:
Dream Scape BBS - 417-883-4035..
∙ From the official Imagine Productions World Wide Web site:
http://www.cland.net/~dsbbs/imagine.html
If you're having any problems with RA-Lister v1.0, if you have a
suggestion for a future version, or need to contact me for some other
reason, there are several ways you can do so:
- Send FidoNet netmail: 1:284/22
- Logon to Dream Scape BBS: (417) 883-4035
- Send internet e-mail: jason.raphael@c-matrix.springfield.mo.us
-or- jammer@cmaster.com
- Post a message to me in the RA_UTIL FidoNet echo
- Send me mail via U.S. Postal service:
Dream Scape BBS
1730 East Republic Road A-123
Springfield, MO 65804-7502
- 12 -
──═════════════════════──
Other Fine RA Utils
──═════════════════════──
Be sure to check out these other fine RemoteAccess utilities by Imagine
Productions:
RA-Pager v1.55 - SysOp pager for
RemoteAccess v2.0x and v2.5x.
----------------------------------------
Many improvements over RA's internal
pager. Allows you to continue using
RA's SysOp chatter with a much
improved interface and many more
features such as:
- Full logging of all activity/page
reasons to a separate log
- Full lightbar support of all prompts
- Moving bars during paging
- Page reason and leave message prompt,
just like in registered RA
..And much more!
* Another fine RA Q-A program *
[FREQable from 1:284/22 as magicname: RA-PAGER]
- RAPSA v1.0 -
RAPSA is a simple batch file utility
to adjust the status of RemoteAccess
paging (on or off) from your DOS prompt.
[Distributed with RA-Pager archive]
- - - - - - - - - - - - - - - - - - - - - - - - - - -
- Visit Imagine Productions on the World Wide Web! -
- http://www.cland.net/~dsbbs/imagine.html -
- - - - - - - - - - - - - - - - - - - - - - - - - - -